home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 25 / CU Amiga Magazine's Super CD-ROM 25 (1998)(EMAP Images)(GB)(Track 1 of 2)[!][issue 1998-08].iso / CUCD / Programming / ixemul / sdk / man / cat5 / passwd.0 < prev    next >
Encoding:
Text File  |  1998-06-15  |  5.8 KB  |  138 lines
  1.  
  2. PASSWD(5)                  UNIX Programmer's Manual                  PASSWD(5)
  3.  
  4. NNAAMMEE
  5.      ppaasssswwdd - format of the password file
  6.  
  7. DDEESSCCRRIIPPTTIIOONN
  8.      The ppaasssswwdd files are files consisting of newline separated records, one
  9.      per user, containing ten colon (``:'') separated fields.  These fields
  10.      are as follows:
  11.  
  12.            name      User's login name.
  13.  
  14.            password  User's _e_n_c_r_y_p_t_e_d password.
  15.  
  16.            uid       User's id.
  17.  
  18.            gid       User's login group id.
  19.  
  20.            class     User's general classification (unused).
  21.  
  22.            change    Password change time.
  23.  
  24.            expire    Account expiration time.
  25.  
  26.            gecos     General information about the user.
  27.  
  28.            home_dir  User's home directory.
  29.  
  30.            shell     User's login shell.
  31.  
  32.      The _n_a_m_e field is the login used to access the computer account, and the
  33.      _u_i_d field is the number associated with it.  They should both be unique
  34.      across the system (and often across a group of systems) since they con-
  35.      trol file access.
  36.  
  37.      While it is possible to have multiple entries with identical login names
  38.      and/or identical user id's, it is usually a mistake to do so.  Routines
  39.      that manipulate these files will often return only one of the multiple
  40.      entries, and that one by random selection.
  41.  
  42.      The login name must never begin with a hyphen (``-''); also, it is
  43.      strongly suggested that neither upper-case characters or dots (``.'') be
  44.      part of the name, as this tends to confuse mailers.  No field may contain
  45.      a colon (``:'') as this has been used historically to separate the fields
  46.      in the user database.
  47.  
  48.      The password field is the _e_n_c_r_y_p_t_e_d form of the password.  If the
  49.      _p_a_s_s_w_o_r_d field is empty, no password will be required to gain access to
  50.      the machine.  This is almost invariably a mistake.  Because these files
  51.      contain the encrypted user passwords, they should not be readable by any-
  52.      one without appropriate privileges.
  53.  
  54.      The group field is the group that the user will be placed in upon login.
  55.      Since this system supports multiple groups (see groups(1))  this field
  56.      currently has little special meaning.
  57.  
  58.      The _c_l_a_s_s field is currently unused.  In the near future it will be a key
  59.      to a termcap(5) style database of user attributes.
  60.  
  61.      The _c_h_a_n_g_e field is the number in seconds, GMT, from the epoch, until the
  62.      password for the account must be changed.  This field may be left empty
  63.      to turn off the password aging feature.
  64.  
  65.  
  66.      The _e_x_p_i_r_e field is the number in seconds, GMT, from the epoch, until the
  67.      account expires.  This field may be left empty to turn off the account
  68.      aging feature.
  69.  
  70.      The _g_e_c_o_s field normally contains comma (``,'') separated subfields as
  71.      follows:
  72.  
  73.            name      user's full name
  74.            office         user's office number
  75.            wphone         user's work phone number
  76.            hphone         user's home phone number
  77.  
  78.      This information is used by the finger(1) program.
  79.  
  80.      The user's home directory is the full UNIX path name where the user will
  81.      be placed on login.
  82.  
  83.      The shell field is the command interpreter the user prefers.  If there is
  84.      nothing in the _s_h_e_l_l field, the Bourne shell (_/_b_i_n_/_s_h) is assumed.
  85.  
  86. YYPP SSUUPPPPOORRTT
  87.      If YP is active, the ppaasssswwdd file also supports standard YP exclusions and
  88.      inclusions, based on user names and netgroups.
  89.  
  90.      Lines beginning with a ``-'' (minus sign) are entries marked as being ex-
  91.      cluded from any following inclusions, which are marked with a ``+'' (plus
  92.      sign).
  93.  
  94.      If the second character of the line is a ``@'' (at sign), the operation
  95.      involves the user fields of all entries in the netgroup specified by the
  96.      remaining characters of the _n_a_m_e field.  Otherwise, the remainder of the
  97.      _n_a_m_e field is assumed to be a specific user name.
  98.  
  99.      The ``+'' token may also be alone in the _n_a_m_e field, which causes all
  100.      users from the _p_a_s_s_w_d_._b_y_n_a_m_e and _p_a_s_s_w_d_._b_y_u_i_d YP maps to be included.
  101.  
  102.      If the entry contains non-empty _u_i_d or _g_i_d fields, the specified numbers
  103.      will override the information retrieved from the YP maps. As well, if the
  104.      _g_e_c_o_s_, _d_i_r or _s_h_e_l_l entries contain text, it will override the informa-
  105.      tion included via YP.  On some systems, the _p_a_s_s_w_d field may also be
  106.      overriden.
  107.  
  108. SSEEEE AALLSSOO
  109.      chpass(1),  login(1),  passwd(1),  getpwent(3),  netgroup(5),
  110.      adduser(8),  pwd_mkdb(8),  vipw(8),  yp(8)
  111.  
  112.      _M_a_n_a_g_i_n_g _N_F_S _a_n_d _N_I_S (O'Reilly & Associates)
  113.  
  114. BBUUGGSS
  115.      User information should (and eventually will) be stored elsewhere.
  116.  
  117.      Placing YP exclusions in the file after any inclusions will have unex-
  118.      pected results.
  119.  
  120. CCOOMMPPAATTIIBBIILLIITTYY
  121.      The password file format has changed since 4.3BSD.  The following awk
  122.      script can be used to convert your old-style password file into a new
  123.      style password file.  The additional fields ``class'', ``change'' and
  124.      ``expire'' are added, but are turned off by default.  Class is currently
  125.      not implemented, but change and expire are; to set them, use the current
  126.      day in seconds from the epoch + whatever number of seconds of offset you
  127.      want.
  128.  
  129.            BEGIN { FS = ":"}
  130.            { print $1 ":" $2 ":" $3 ":" $4 "::0:0:" $5 ":" $6 ":" $7 }
  131.  
  132. HHIISSTTOORRYY
  133.      A ppaasssswwdd file format appeared in Version 6 AT&T UNIX.
  134.  
  135.      YP file format first appeared in SunOS.
  136.  
  137. BSD Experimental                 July 18, 1995                               3
  138.